home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / boot-tools / darksound / darksound.eng.doc < prev    next >
Text File  |  1996-03-28  |  10KB  |  306 lines
  1. *****************************************
  2. *        `DarkSound'  V 2.2        *
  3. *       An OriginalWare release by      *
  4. *    Troglobyte/Darkness © 1995    *
  5. *****************************************
  6.  
  7. Contents
  8. ========
  9.  
  10.  1. Introduction
  11.  2. Instructions
  12.  3. ToolTypes
  13.  4. Errors and solutions
  14.  5. History
  15.  6. OriginalWare?
  16.  7. Thanks
  17.  8. Credits
  18.  9. Also available
  19. 10. Bugs
  20.  
  21.  
  22. 1. Introduction
  23. ===============
  24.  
  25. Are  you  tired  of  hearing the same sound alert each time the Amiga warns
  26. you?
  27.  
  28. DarkSound  is the answer to your prayers!  It will randomly choose a sample
  29. each time you boot your machine.Now, your errors won't sound the same.#8>)
  30.  
  31. DarkSound  will  play  a  random  Start sample anytime you load it and will
  32. select another random Alert sample to be used as the system sound Alert.
  33.  
  34. DarkSound  is  very  easy  to  install,  and  once installed you can't live
  35. without  it,  and  with  the  correct sample you can always surprise others
  36. Amiga and PC users, you even can surprise yourself.
  37.  
  38.  
  39. 2. Instructions
  40. ===============
  41.  
  42. To  install  DarkSound just drag his icon to the `DH0:WBStartup' drawer, or
  43. copy  the  `DarkSound'  and `DarkSound.info' to you `SYS:WBStartup' drawer.
  44. Then  configure  the ToolTypes of the icon (for more info look at Section 3
  45. of this instructions:  3.  ToolTypes)
  46.  
  47. DarkSound  (optionally)  will play another sample each time you run it; and
  48. as DarkSound must be installed in your `WBStartup' drawer, this sample will
  49. play  anytime  you init your WorkBench, you can use this sample to warn you
  50. that your Workbench finished loading and your Amiga is ready to be enjoyed.
  51. After  this DarkSound will select another random Alert sample to be used as
  52. the  system sound Alert and then will exit.  Both samples are selected from
  53. different sound lists that you must define in the DarkSound icon ToolTypes.
  54. I  recommend  to  use  longer sounds as Start samples and shorter sounds as
  55. Alert samples, but you can use whatever you want.
  56.  
  57. The  sound  samples  provided  are  only  for  test, use your own favourite
  58. sounds.
  59.  
  60. You  can use the `DH0:Prefs/Sound' preferences editor, to select the volume
  61. of  the  samples  and  if  you want a screen flash together with the System
  62. Alert sample.
  63.  
  64. When  DarkSound  is  executed  it  change  your  sound  prefs  and exit, so
  65. DarkSound don't waste nothing of your precious CPU time and memory.
  66.  
  67. DarkSound  only edit your RAM:  configuration (RAM:ENV/Sys/Sound.Prefs), so
  68. DarkSound never WRITE nothing to your Hard Disk.
  69.  
  70. All this is more simple than it sounds #8>) so just check it.
  71.  
  72.  
  73. 3. ToolTypes
  74. ============
  75.  
  76. Now you can/must configure DarkSound with the icon ToolTypes.
  77.  
  78. To  edit configuration, click once the DarkSound icon and press right mouse
  79. button  to  select  in the Workbench menu `Icons' the `Information' option,
  80. you  can  select it pressing at the same time the right `Amiga' key and the
  81. `I' key.Then a window will appear to easily write your own configuration.
  82.  
  83. There are 2 ToolTypes to select the Start sample :
  84.  
  85.  ToolType 1 : Start_Name=dh0:Sounds/Sample00.Iff
  86. With  this  you  select  the  path and name of the Start sample you want to
  87. play.   Remember  that  all the samples must have the same name, and a `00'
  88. string anywhere in the name of the sample, but the Sample00 isn't used.
  89.  Examples :
  90. dh1:Sounds/Sound00    - OK
  91. SYS:Sample.00.IFF    - OK
  92. DH0:Sound13        - Bad : the number must be 00 (Sound00, OK)
  93. dh1:Sound000        - Bad : the number must be 2 digit only (Sound00)
  94.  
  95.  ToolType 2 : Start_Number=03
  96. This  is  the number of samples.  If the number is `00' the Start Sample is
  97. OFF.
  98.  Example :
  99. With this ToolTypes,
  100.  START_NAME  =dh0:Sounds/Sample00.Iff
  101.  START_NUMBER=03
  102. you must have the samples :
  103.  dh0:Sounds/Sample01.Iff
  104.  dh0:Sounds/Sample02.Iff
  105.  dh0:Sounds/Sample03.Iff
  106.  
  107. There  are  other  2  ToolTypes  to  select  the  System Alert sample, this
  108. ToolTypes  are  used  like  the  previous 2 ToolTypes, you can use the same
  109. samples or other samples.
  110.  
  111.  ToolType 3 : Alert_Name  =dh0:Sounds/Alert00.Iff
  112.  
  113.  ToolType 4 : Alert_Number=07
  114.  
  115. The other ToolTypes are standard Workbench ToolTypes, and usually you don't
  116. need to change them; if you don't know what they do, don't touch them.
  117.  
  118.  ToolType 5 : StartPriority=0
  119. This  ToolType  is  used  to  select  in which order WBStartup programs are
  120. loaded, if you use the Start sample I recomend to load DarkSound the last.
  121.  
  122.  ToolType 6 : DoNotWait
  123. This ToolType tell the system Do Not Wait to this program to finish, so the
  124. system continue loading other programs while executing DarkSound.
  125.  
  126.  
  127. 4. Errors and solutions
  128. =======================
  129. If `DarkSound' found any error will open a window with the problem, it will
  130. help you to check out and correct your problems.
  131.  
  132. WorkBench 2.1 or later required by DarkSound to work (if you have KickStart
  133. 1.x consider DarkSound another good reason to upgrade your Amiga).
  134.  
  135. DarkSound  must  be copied in the `SYS:WbStartup' drawer, you must copy the
  136. program  `DarkSound'  and the icon `DarkSound.info' with this names, if you
  137. rename this files, the program won't work.
  138.  
  139. The  file  `RAM:ENV/Sys/Sound.Prefs' is required, if you don't have it, use
  140. the `SYS:Prefs/Sound' program to create it and select your preferences.
  141.  
  142. Remember  that  your old `sound.prefs' sample selections are overwritten by
  143. DarkSound  in  RAM:   but  are  still  in your hard disk, so if one day you
  144. decide   to  stop  using  DarkSound,  your  original  preferences  will  be
  145. automatically used again.
  146.  
  147. If you get the system error `Sound.Prefs is a BAD Prefs File', then one
  148. of your sounds isn't a standard IFF sample, check them with a sound program.
  149. There can be only 100 samples, but this must not be a problem (I think).
  150.  
  151. If you have any other problem or doubt, contact me (address is at the end)
  152.  
  153.  
  154. 5. History
  155. ==========
  156.  
  157. Version 1.1 ( 8-Apr-94) :
  158.   - First released version.
  159.  
  160. Version 1.2 (20-May-94) :
  161.  - Play the LAST sound in the list when run it to alert you that your
  162.    WorkBench is loaded, (you can use a long sample like `Commodore is
  163.    dead but your Amiga is still the best computer  and is ready to be
  164.    used' and use smaller samples as alerts) and choose another sample
  165.    randomly for the WB Sound Alert.
  166.  - Improved Docs.
  167.  - MagicWB Icon added.
  168.  - More Samples included (but not good enough yet). 
  169.  
  170. Version 1.3 (20-Sep-94) :
  171.  - If you use it from CLI will display errors.
  172.  - Code optimized for future versions.
  173.  - FIDO address added :-)
  174.  
  175. Version 2.0 (10-Nov-94) :
  176.  - Major update.
  177.  - Different sound lists for Start and Alert samples.
  178.  - Added ToolTypes for configuration.
  179.  - Docs in AmigaGuide format.
  180.  - Spanish docs added.
  181.  
  182. Version 2.1 (25-Nov-94) :
  183.  - Open a window with the errors found.
  184.  
  185. Version 2.2 ( 6-Jan-95) :
  186.  - Search for the icon in the current dir (not only in the "WBStartup" dir)
  187.  - Better random sample selector routine  
  188.  - Minor Bugs fixed
  189.  
  190.  
  191. 6. OriginalWare ?
  192. =================
  193.  
  194. This  utility  is OriginalWare.That means if you like this program you must
  195. buy  an  original  Amiga program or game or send the money to the author of
  196. any ShareWare program or game you are using often.
  197.  
  198. There  are  lots  of  great Amiga software like `DiskMaster', `Remind',
  199. `MultiCX', `Goal' and a lot more that you won't never regret to spend your
  200. money.
  201.  
  202. If  you do this you support the Amiga, and if you support AMIGA you support
  203. US.
  204.  
  205. Support OriginalWare software and you will get more and better software.
  206.  
  207. DarkSound could be included in any PD compilation, except some samples that
  208. could have different copyrights.
  209. Fred Fish and Aminet collections are specifically allowed to use it.
  210.  
  211.  To Magazines :
  212. You can give away this utility on your coverdisk, but please send me a copy
  213. of the magazine.
  214.  
  215.  
  216. 7. Thanks to:
  217. =============
  218.  
  219. Amiga Vice for the idea and the ßeta testing.
  220. Hipnooxis for ALL the help and show me to use and respect the Amiga O.S.
  221. Binary for the help with the first docs and much more things.
  222. Knackosoft/TRSI for being my best `invisible' friend.
  223. Alberto Sanchez and David Santamaria for some help in this project.
  224.  
  225. Everybody responsible of the nice samples.
  226.  
  227. To all the Amiga developers for all the new, fun and useful stuff.
  228.  
  229. To all the Amiga users worldwide for their trust in the Amiga.
  230.  
  231. To Amiga Technologies for continue the development of the Amiga.
  232.  
  233. To you for read this and for use DarkSound (because you use it...or not?)
  234.  
  235. To the Amiga...
  236.  
  237.  
  238. 8. Credits
  239. ==========
  240.  
  241. All code © 1996 by Troglobyte/Darkness.
  242.  
  243. Send us money ($), JOB offers, BUGS, comments, improvements, ideas, advices,
  244. suggestions, mags, complains, and nice  PD  stuff  (like Demos, Games or
  245. Utilities).
  246.  
  247.             M. Martin Vivaldi
  248.              Av. America 60
  249.               Madrid 28028
  250.                  SPAIN
  251.  
  252. Or NetMail me at :
  253.  
  254.  Internet : bitabit@servicom.es
  255.  
  256.  FidoNet  : 2:341/28.55        Manuel Martin
  257.  
  258.  AmigaNet : 39:192/1.29        Manuel Martin
  259.  
  260. Remember:
  261.  
  262. Only Amiga make it possible... Only Amiga make it fun.
  263.  
  264.  
  265. 9. Also available...
  266. ====================
  267.  
  268. Others quality Amiga PD products available from me :
  269.  
  270. Aminet recent uploads :
  271.  
  272. DKSnd21.lha   v2.1   util/boot   52K Changes Workbench Sounds at each boot.
  273. Progress.lha  v1.0   demo/intro  73K In Progress/Darkness.1st at Euskal Party
  274. Vector13.lha  v1.3   dev/misc    15K Draw and edit 2D vectors for demos/games
  275. TheRace5.lha  v1.5   game/2play  59K Great 100m Running game, 0-4 players.
  276.  
  277. Available soon:
  278.  
  279. HTMLess.lha   v1.0   text/misc         Converts HTML files in text files.
  280. DarkSound.lha v2.2   util/boot   55K Changes Workbench Sounds at each boot.
  281. MagiCA64.lha  v1.1   misc/emu     6K Converts A64/64 files to MagiC64 format.  
  282. ELF.lha       v1.0   text/misc         Erase Line Feeds.Use for Word Procesors.
  283. FormaText.lha v1.0   text/misc         Format texts to your chosen columns size 
  284.  
  285. All them are 100% written in pure assembler for speed and are very system 
  286. friendly in all types of Amiga computers (or that is what I hope *8).
  287.  
  288.  
  289. 10. Bugs
  290. =======
  291.  
  292. There isnt any KNOWN bugs at the moment in all the Amigas tested but...
  293.  
  294. If you find any bug or problem, contact me at the previous address.Please,
  295. send me a detailed report of the problem and of your Amiga computer if
  296. possible; thanks.
  297.  
  298. If you found the problem with a particular file, send me too a copy of
  299. the file.
  300.  
  301. Don't forget to tell me the current version of my program you are using.
  302.  
  303.  
  304.  
  305.  
  306.